======= AC Sensorizer v0.2 =======

[[acsensorizer|{{    ac:sensorizer_logo.jpeg}}]]

\\
\\
[[acsensorizer_02|{{http://www.audiocommander.de/picBrowser/phpThumb.php?src=galleries/060827_sensorizer/sensorizer_stage_3d_front.jpg&w=200&h=133/ext=.jpg?200x133}}]]\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
:!:\\
**This sensorizer project (version 0.2) uses an outdated GUI. There will be no further developments; instead go and build the new ACSensorizer - there have been made major improvements in the GUI/HUI => [[ACSensorizer_basic|AC Sensorizer 0.4]]**
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\
\\









====== Description =====

**//AC Sensorizer sensorizes up to 8 sensors and interpolates its AIN-readings.
The main target of this application are sensoric devices delivering not exactly 
0 - 5 V, like pressure-, distance-, resistor-based sensors or softPots.//**

:!:\\
This is a preliminary beta-release.\\
Use and build at your own risk!\\
There have been made major improvements in the GUI/HUI within the **newer release called [[ACSensorizer_basic|AC Sensorizer Basic]]** ...\\
The **Sensorizer Stage** (this one here) will be updated later on, but it is very likely that one more DIN and some more Encoders will be added!
// -- audiocommander//


{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_sensorizer_snap_010.jpg?150}}
{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_sensorizer_snap_002.jpg?150}}
{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_sensorizer_snap_103.jpg?150}}
{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_sensorizer_snap_001.jpg?150}}\\
{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_sensorizer_snap_006.jpg?150}}
{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_sensorizer_snap_007.jpg?150}}
{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_sensorizer_snap_105.jpg?150}}
{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_sensorizer_snap_111.jpg?150}}\\

Picture Gallery: http://www.audiocommander.de/picBrowser/picBrowser.php?go=galleries/060827_sensorizer&thumbs=1&thumbsize=XL \\
\\

{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_smp01_billig-short.mov.jpg?200}}
{{http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/m5_smp02_iwnh-short.mov.jpg?200}}\\

Demo-Video 1: http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/,m5_smp01_billig-short.mov \\
Demo-Video 2: http://www.audiocommander.de/picBrowser/galleries/060827_sensorizer/,m5_smp02_iwnh-short.mov \\

audicommander's YouTube Video Page: http://www.youtube.com/profile?user=audiocommander

Note: \\
//The Sensorizer is attached to a Computer which converts the Controller Messages – produced by the Sensorizer – to harmonized and clock-synchronized Note-Signals. I'm using Absynth Sounds ...but due to the buggy versions I'm looking forward to use a hardware synth somewhen //

\\

===== Features =====

  * supports up to 8 sensors, code can be adapted to use more (eg with PIC18F4620)
  * enable/disable single AINs
  * slowdown: slows down the signal and increases the gaps between generated values
  * assignable CH and Controller-Number
  * sense-min: 10bit value, ignores every signal below
  * sense-max: 10bit value, ignores every signal above
  * sense-factor: used for signal interpolation... uses fast bitshifting or complex division depending on value
  * AUTO-sense feature: auto-calibration of sensor, detect MIN/MAX by sensing automatically adapts sense-factor!
  * scale from and scale to: scales the output value from/to
  * invert signal
  * pedal modes:
    * filter => only forward if pedal down; 
    * panic  => send panic on release pedal; 
    * combinations of all pedal mode options are possible 
  * detect release: send 0-value if signal drops below sense-min
  * bankstick support: 1 connected bankstick provides 2 banks with 127 patches each
  * midi configurable: full configuration possible with NRPN-messages 
    * NRPN-MSB CC99 for sensorSelect / sysEx mode
    * NRPN-LSB CC98 for controlType
    * DataEntry MSB CC6 and LSB CC38 for controlValue
  * LCD-Output (2x16 or -recommended- 4x20)
  * HUI-Input to control up to 4 sensors with 8 switch-encoders, pedal, store- & panic-button in 2 modes (PLAY/SETUP)
  * ACSim Console Debugger: code integrated and ready to use configured for XCode2
    * select "ACSim" as target and test the application via command-line
    * inspect variables with a (graphical) debugger (GDB support within XCode2)
    * visit http://www.midibox.org -> there's a tutorial how to use Code::Blocks





\\
===== Required hardware===== 

**MBHP Modules:**
   * one MBHP_CORE module
   * one MBHP_LCD module (5x20 optimized, 2x16 available)
   * one MBHP_DIN module for
		* 8 Encoders (preferrably with):
		* 8 pushButtons
		* 1 mode-select switch
		* 1 pedal (optional)
		* 1 PANIC button (optional)
		* 1 STORE button (optional)
		* 1 UP & 1 DOWN button (optional)

**Sensors:**
   * up to 8 (default: 4) sensors connected to unmuxed AIN (J5 of MBHP_CORE). Note that sensors 5 to 8 can only be configured via MIDI by sending NRPN-messages






\\

====== Application Software ======

  * [[http://www.audiocommander.de/downloads/midibox/m5_sensorizer_024.zip|m5 sensorizer v 0.2.4]] (348 kB), download from http://www.audiocommander.de
  * [[http://www.audiocommander.de/downloads/midibox/m5_sensorizer_024_readme.txt|readme.txt]]  ...you should really read this, even if you're not recompiling the software!

\\
//Version History//
  * 0.2.2:
    * initial release
  * 0.2.3:
    * removed MidiTrough and used MIOS_Merger
    *	some minor bugs
    *	two example miniAudicle/Chuck NRPN scripts are now included
  * 0.2.4: 
    * fixed severe bank select bug that prevented accessing even banks

\\
//Compiling Notes//

The application can be recompiled with a variety of strictly separated #define-
options. For example setting SENSORIZER_INTERFACE_HUI to 0 compiles the application 
without hardware input controls and therefore reduces the file- and application space.
Compiling without HUI, BANKSTICK, NRPN-Config and LCD generates code with approx. 3 or 4 pages; compiling with all options will result in an application file of approx. 12 to 14 pages.





\\
\\

====== MIDI-Controllable Parameters ======

All Sensorizer parameters can be controlled and set by sending NRPN messages by MIDI: 

1. Send NRPN MSB (Controller# 99) to select control type\\
2. Send NRPN LSB (Controller# 98) to set the control parameter\\
3. Send NRPN Data MSB (Controller# 6) and NRPN Data LSB (Controller# 38) to set the parameter value\\

\\
^ NRPN MSB | | | |
^ CC ^ Value ^ Control Type ^ Note ^
| CC99, 0x63 | 0..7 | Sensor 0..7 | See Table B |
| CC99, 0x63 | 126 | SysEx mode: ON | n/a |
| CC99, 0x63 | 127 | SysEx mode: OFF | n/a | 
//  Table A: Control Types//

\\
^ NRPN LSB | | ^ DATA ENTRY MSB/LSB | | |
^ CC ^ Value ^ Control Parameter ^ CC ^ Value ^ Description ^
| CC98, 0x62 | 0x00 | enabled | CC38, 0x26 | 0/1 | ON/OFF | 
| CC98, 0x62 | 0x01 | pedalMode | CC38, 0x26 | 0..7 | FILTER/HOLD/PANIC/KOMBI |
| CC98, 0x62 | 0x02 | autoSense | CC38, 0x26 | 0..2 | AUTOSENSE_OFF/_MIN/_MAX | 
| CC98, 0x62 | 0x03 | invert | CC38, 0x26 | 0/1 | 0..127 or 127..0 |
| CC98, 0x62 | 0x04 | releaseDetect | CC38, 0x26 | 0/1 | send 0 on release | 
| CC98, 0x62 | 0x10 | slowdown | CC38, 0x26 |0..127 | drop AIN notifications | 
| CC98, 0x62 | 0x11 | sense_min | CC38, 0x26 & CC6, 0x6 | 0..1023 | drop below and set sense minimum | 
| CC98, 0x62 | 0x12 | sense_max | CC38, 0x26 & CC6, 0x6 | 0..1023 | drop above and set sense maximum |
| CC98, 0x62 | 0x13 | sense_factor | CC38, 0x26 | 0..64 | f=(range/127) |
| CC98, 0x62 | 0x21 | scale_from | CC38, 0x26 | 0..127 | restrict and rescale output |
| CC98, 0x62 | 0x22 | scale_to | CC38, 0x26 | 0..127 | restrict and rescale output |
| CC98, 0x62 | 0x70 | CH | CC38, 0x26 | 0..15 | MIDI Channel of sensor |
| CC98, 0x62 | 0x71 | CC | CC38, 0x26 | 0..127 | MIDI Controller Change Number of sensor |
//  Table B: Control Parameters//




\\
\\

====== HUI-Controllable Parameters ======

:!: **The design of the Encoders is about to change with the next version. I just had one DIN at hand and the whole project had to be finished in time; with a second DIN and 4/5 more Encoders, everything will be a bit handier...**

If you build the Sensorizer with enabled HUI-mode, it provides configuration possibilities for 4 sensors. However, you could change the code easily to support all 8 sensors.

Used Hardware:
  * 1 Mode-Switch button (PLAYMODE <-> SETUPMODE)
  * 8 Encoders with Switch, two Encoders per sensor, the first row of encoders is called ENC_MIN, the lower ENC_MAX
  * 4 Buttons (UP, DOWN, STORE, PANIC)

\\
^ Function ^ Encoder(s) ^ PLAYMODE ^ SETUP-MODE ^
| Turn     | ENC_MIN    | slowdown factor | scale from |
| Turn     | ENC_MAX    | send value      | scale to   |
| Press & Turn | ENC_MIN | CH (MIDI Channel) | senseMin (10bit) |
| Press & Turn | ENC_MAX | CC (MIDI Controller) | senseMax (10bit) |
|       | | | |
| Press | ENC_MIN + ENC_MAX | sensor ON | AUTOSENSE_MIN |
| Press | ENC_MAX + ENC_MIN | sensor OFF | AUTOSENSE_MAX |
|       | | | |
| Press | PANIC + PEDAL | switch PEDALMODE (Mode 0 to 7) | |
| Press | PANIC + ENC_MAX | switch RELEASE DETECT (ON/OFF) | |
| Press & Turn | PANIC + ENC_MAX | senseFactor (0-32) | - |
//  Table C: Encoder Controls//


\\
\\

====== BANKSTICK Patch Description ======
m5_sensorizer supports writing and reading to a connected bankstick.\\
Each patch consists of 2 pages ˆ 64 bytes => 128 bytes\\
2 banks with 128 patches each are available per 1 connected bankstick

Sending a PRG_CH message in PLAYMODE [P] loads the corresponding patch.\\
Sending a PRG_CH message in SETUPMODE[S] sets the corresponding patch without loading the patch data. Use this behavior to copy patches.

Choose the appropriate bank by sending a Coarse-Adjust Bankselect (CC#0).\\
In HUI-Mode, switching a bank on the device also sends the current Bank/PRG.\\

Memory-map of one patch:\\

^ Data        ^ Size in Bytes = Sum ^ Page     ^ Address   ^
| Version         | 01 =  1         | 1 @ 0x00 | 0 @ 0x00  |
| PatchName       | 15 = 16         | 1        | 1         |
|   <reserved>    | 08 = 24         | 1        | 16 @ 0x10 |
| sensor[8]       | 08 = 32         | 1        | 24        |
| CH[8]           | 08 = 40         | 1        | 32 @ 0x20 |
| CC[8]           | 08 = 48         | 1        | 40        |
|   <reserved>    | 16 = 64         | 1        | 48 @ 0x30 |
|                 | | | |
| slowdown[8]     | 08 =  8         | 2 @ 0x40 | 0 @ 0x00  |
| sense_factor[8] | 08 = 16         | 2        | 8         |
| sens_min[8].MSB | 08 = 24         | 2        | 16 @ 0x10 |
| sens_min[8].LSB | 08 = 32         | 2        | 24        |
| sens_max[8].MSB | 08 = 40         | 2        | 32 @ 0x20 |
| sens_max[8].LSB | 08 = 48         | 2        | 40        |
| scale_from[8]   | 08 = 56         | 2        | 48 @ 0x30 |
| scale_to[8]     | 08 = 64         | 2        | 56        |
// Table D: Bankstick Patch Content//

Patch addresses are: (patch * 0x80)\\
or PIC-optimized: (unsigned int)patch << 7

\\
Example hex-output of patch#0:

<code>
**MIOS_BANKSTICK_WritePage at 0x0 
0:     02 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................
16:    00 00 00 00 00 00 00 00 80 80 80 80 40 08 00 00  ............@...
32:    00 00 00 00 04 04 04 04 14 15 16 17 00 00 00 00  ................
48:    00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00  ................

**MIOS_BANKSTICK_WritePage at 0x40 
0:     08 08 08 08 00 00 00 00 04 04 04 04 00 00 00 00  ................
16:    00 00 00 00 7f 00 00 00 40 40 40 40 7f 00 00 00  ........@@@@....
32:    03 03 03 03 00 00 00 00 70 70 70 70 40 40 40 40  ........pppp@@@@
48:    00 00 00 00 00 00 00 00 7f 7f 7f 7f 00 00 00 00  ................
</code>



\\
\\
\\
More details can be found in the readme.txt!\\
This site is about to change while the Sensorizer is beeing developed further!\\

have fun! // -- audiocommander //